ReleaseNotes

Feature (2024-12-12)

desc: New Features and Optimizations

content:

Event Push Service Enhancement

Details:
- Reintroduced robot-related information (mapId, mapName) in the event push service.
- Note: This data is simulated and derived from approximated robot states, not actual data.
- Version Applicability: Applicable to versions prior to aio1.3hotfix9. For aio1.3hotfix9 and later versions, data will be based on real-time robot states.

Task Report Query Logic Optimization

API Affected: /openapi/*/taskReports
Enhancements:
- Introduced the following time range parameters to optimize query logic:
  - startTimeMin / startTimeMax: Define the minimum and maximum values for task start time.
  - endTimeMin / endTimeMax: Define the minimum and maximum values for task end time.
- Impact:
  - Resolves issues in previous query logic.
  - Improves flexibility and accuracy of task report queries.

Enhancements to Robot Status API

API Affected: /openapi/v2alpha1/s/robots/{robot}/status
Enhancements:
- Deployment Point Coordinates:
  - Added navigationPoints, which include x and y coordinates of deployment points. This enables state assessment after robot movement.
  - Recommendation: Use the GIS Distance method for coordinate evaluation.
  - Version Applicability: Applicable to versions prior to aio1.4hotfix1 with Phantas. For aio1.4hotfix1 and later versions, data will be based on real-time robot states.
- Device/Consumable Information:
  - Added support for monitoring robot-related devices and consumables, including:
    - Charging Current
    - Vacuum Fan Status
    - Clean Water Filter Status

Feature (2024-09-26)

desc: The overall optimization of relevant interface documentation to make it more accessible and understandable. New information has been added regarding device maps and subarea details of the maps.

content:

Added API Call Examples (Demo) for All Interfaces
We have introduced detailed examples for each API interface to help developers better understand and use the APIs. These examples include request payloads and corresponding response examples.
New API Endpoints for Retrieving Robot Map List and Subarea Information
We have added two new endpoints related to robot maps to enhance the interactivity of the map functionality:
/openapi/v1/map/robotMap/list: This endpoint retrieves a list of maps used by robots, including information such as the map ID and map name.
/openapi/v1/map/subareas/get: This endpoint retrieves subarea information within the robot map, offering finer-grained control for services requiring more precise robot area operations.
Adjusted M/S Temporary Task Deployment Process Description
We have updated the process description for the M-line/S-line robot temporary task deployment interface to improve its readability.

Feature (2024-08-15)

desc: Enhancements to Device Status, Event Push Services, and Task Report Query & Push Services

content:

Robot Status Changes
New Additions: The Robot Status Interface has been updated to include the status of various devices and their consumable life. The devices are: Main Brush, Disk Brush, Left Side Brush, Right Side Brush, Soft Rubber Squeegee, Roller Squeegee, Standard Dust Mop, Rolling Dust Mop, Filter, Water Valve
Changes to V2 Task Report Retrieval and Task Push
New Fields: The following fields have been added to the V2_ListRobotTaskReports and TaskReportPush interfaces.taskId (Pre-deployed Combination Task ID), planId (Schedule Plan ID), subTaskId (Subtask ID)
Changes to Incident Push Service
New Fields: The IncidentPush interface now includes the following fields: taskId (Pre-deployed Combination Task ID), subTaskId (Subtask ID), taskInstanceId, taskName, mapId, mapName
Data Source Change: The data source for these fields has transitioned from data fitting to being reported directly by the machine. There may be instances of version rollback. Before the AIO1.3 hotfix, these fields may be empty
Incident Code Update: For incident codes 50001 and 50002, the incident name in the push notification will include the task name

Feature (2024-07-01)

desc: Enhanced Event Push Service

content: Added aggregation fields to the event push service, including robot location map and task name at the time of event occurrence. These additional fields provide customers with more comprehensive task background information, making event pushes more valuable and helping customers better understand and manage robot operational status.

Hotfix (2024-05-27)

desc: Enhanced Task Recovery Capability

content: Optimized task recovery capability for non-AIO versions of Phantas. This optimization improves the reliability and continuity of tasks in non-integrated system environments, ensuring stable task execution.

Feature (2024-05-06)

desc: Optimized Event Push Service

content: Optimized the event push service, establishing data associations between user event subscriptions and service event pushes. This improvement allows users to subscribe to and manage various event notifications more effectively, enhancing event handling efficiency and user experience.

Feature (2024-04-26)

desc: New Task Report Interface

content: Introduced the task report interface v2alpha1/ListRobotTaskReports. This interface provides enhanced functionality for users to retrieve and analyze robot task report data in detail, thereby improving data visualization and decision support capabilities.

Feature (2024-03-21)

desc: Siteless Temporary Task Dispatch Channel

content: Added Phantas siteless temporary task dispatch channel (SendTempTaskCommand). This feature allows customers to flexibly dispatch temporary tasks to robots without relying on predefined sites, enhancing task scheduling flexibility and efficiency.

Hotfix (2024-03-11)

desc: Optimized Initialization Coordinate Type

content: Fixed a bug related to robot movement commands caused by case sensitivity in cloud data, optimizing the initialization coordinate type from double to int. This fix resolves issues with command execution caused by data type mismatches, ensuring precise and stable robot movement.

Feature (2023-12-22)

desc: Enhanced Event Push Service

content: Added task start and task end push functionalities, allowing customers to understand dynamic changes in robot task execution more clearly. This enhancement not only strengthens visibility into task status but also improves customer grasp of task progress, enabling timely business adjustments.